Transport Settings

1. Overview

The Transport Settings document in the VSD Fleet Management System (VSD Fleet MS) module is used to configure and centralize transport-related configuration values for fleet operations. It acts as a foundational setup to define default fuel items, item groups, expense and account mappings, and accounting dimensions. These settings ensure consistent behavior across other transport-related documents and operations within the system.

2. Key Features

• Configure the default warehouse for vehicle fuel issuance.
• Set default Sales Item Group and Fuel Item Group.
• Define the default Fuel Item to be used across the fleet module.
• Map multiple Expense Account Groups and Cash or Bank Account Groups using child tables.
• Assign accounting dimensions to categorize financial entries across departments or business units.

3. Pre-Requisites

Before configuring the Transport Settings, ensure that the following master data records are available:

• Warehouse: For selecting the vehicle fuel parent warehouse.
• Item Groups: To choose for sales and fuel categories.
• Item: At least one fuel item should be created under the selected Fuel Item Group.
• Transport Expenses Account Group and Transport Cash Account Group: To populate expense and cash/bank mappings.
• Transport Accounting Dimension: To allocate accounting breakdowns.

4. Step-by-Step Usage

1. Navigate to Transport Settings
   Go to:
   VSD Fleet MS → Settings → Transport Settings

2. Configure Basic Information

   • Vehicle Fuel Parent Warehouse: Select a warehouse where fuel is stored and managed.
   • Sales Item Group: Choose the item group under which vehicle service-related sales items fall.
   • Fuel Item Group: Select the group that classifies fuel products.
   • Fuel Item: Choose a default fuel item from the Item master. (This field is mandatory.)

3. Add Accounting Groups

   • Expense Account Group: Use the multi-select child table to map multiple expense accounts under the Transport Expenses Account Group.
   • Cash or Bank Account Group: Similarly, select cash/bank accounts relevant for fuel or transport payments.

4. Add Accounting Dimensions

   • In the Accounting Dimension section, define dimension values using the linked child table to the Transport Accounting Dimension Doctype.

5. Save the Settings
   Once all fields are filled, click Save to apply the settings globally across the transport module.

5. Script Customizations

There are currently no server-side scripts or client-side scripts implemented in the default configuration (transport_settings.py). However, Frappe developers can add custom logic such as validations or auto-populations by extending the TransportSettings class.

Example customization ideas:

• Auto-suggest expense accounts based on selected fuel item.
• Validate mandatory setup before allowing vehicle trip creation.

6. Troubleshooting (Common Errors and Resolutions)

7. User Roles and Permissions

By default, the following role has access to the Transport Settings document:

• System Manager
  • Can Create, Read, Update, Delete
  • Can Print, Email, Share

You may customize permissions through Role Permission Manager if needed.

8. Key Notes

• This document is a Single Doctype, meaning only one record exists at a time.
• Fields like Fuel Item are required and are used in automated processes within the Fleet MS module (e.g., fuel requisitions or vehicle trip fuel usage).
• Editing should be limited to authorized personnel due to the impact on downstream documents.

9. What Business Process Pain Point Does It Help Remove

The Transport Settings Doctype helps eliminate inconsistencies and manual errors in selecting default items, accounts, and warehouse configurations during transport operations. It reduces repetitive data entry, ensures financial compliance, and enables smoother integration of accounting dimensions across the Fleet module.